v9.7.6: mkdocs-material-9.7.6

Compare Source

[!WARNING]

Material for MkDocs is in maintenance mode

Going forward, the Material for MkDocs team focuses on Zensical, a next-gen static site generator built from first principles. We will provide critical bug fixes and security updates for Material for MkDocs until November 2026.

Read the full announcement on our blog

Changes

• Automatically disable MkDocs 2.0 warning for forks of MkDocs

v9.7.5: mkdocs-material-9.7.5

Compare Source

[!WARNING]

Material for MkDocs is in maintenance mode

Going forward, the Material for MkDocs team focuses on Zensical, a next-gen static site generator built from first principles. We will provide critical bug fixes and security updates for Material for MkDocs until November 2026.

Read the full announcement on our blog

Changes

• Limited version range of mkdocs to <2
• Updated MkDocs 2.0 incompatibility warning (clarify relation with MkDocs)

v9.7.4: mkdocs-material-9.7.4

Compare Source

[!WARNING]

Material for MkDocs is in maintenance mode

Going forward, the Material for MkDocs team focuses on Zensical, a next-gen static site generator built from first principles. We will provide critical bug fixes and security updates for Material for MkDocs until November 2026.

Read the full announcement on our blog

Changes

• Hardened social cards plugin by switching to sandboxed environment (recommended by @​caveeroo)
• Updated MkDocs 2.0 incompatibility warning

v9.7.3: mkdocs-material-9.7.3

Compare Source

[!WARNING]

Material for MkDocs is in maintenance mode

Going forward, the Material for MkDocs team focuses on Zensical, a next-gen static site generator built from first principles. We will provide critical bug fixes and security updates for Material for MkDocs until November 2026.

Read the full announcement on our blog

Changes

• Fixed #​8567: Print MkDocs 2.0 incompatibility warning to stderr

v9.7.2: mkdocs-material-9.7.2

Compare Source

[!WARNING]

Material for MkDocs is in maintenance mode

Going forward, the Material for MkDocs team focuses on Zensical, a next-gen static site generator built from first principles. We will provide critical bug fixes and security updates for Material for MkDocs until November 2026.

Read the full announcement on our blog

Changes

• Opened up version ranges of optional dependencies for forward-compatibility
• Added warning to mkdocs build about impending MkDocs 2.0 incompatibility (doesn't affect strict mode)

v9.7.1: mkdocs-material-9.7.1

Compare Source

• Updated requests to 2.30+ to mitigate CVE in urllib
• Fixed privacy plugin not picking up protocol-relative URLs
• Fixed #​8542: false positives and negatives captured in privacy plugin

v9.7.0: mkdocs-material-9.7.0

Compare Source

[!WARNING]

Material for MkDocs is now in maintenance mode

This is the last release of Material for MkDocs that will receive new features. Going forward, the Material for MkDocs team focuses on Zensical, a next-gen static site generator built from first principles. We will provide critical bug fixes and security updates for Material for MkDocs for 12 months at least.

→ Read the full announcement on our blog

This release includes all features that were previously exclusive to the Insiders edition. These features are now freely available to everyone.

Note on deprecated plugins: The projects and typeset plugins are included in this release, but must be considered deprecated. Both plugins proved unsustainable to maintain and represent architectural dead ends. They are provided as-is without ongoing support.

Changes:

• Added support for projects plugin (for compat, now deprecated)
• Added support for typeset plugin (for compat, now deprecated)
• Added support for pinned blog posts and author profiles
• Added support for customizing pagination for blog index pages
• Added support for customizing blog category sort order
• Added support for staying on page when switching languages
• Added support for disabling tags in table of contents
• Added support for nested tags and shadow tags
• Added support for footnote tooltips
• Added support for instant previews
• Added support for instant prefetching
• Added support for custom social card layouts
• Added support for custom social card background images
• Added support for selectable rangs in code blocks
• Added support for custom selectors for code annotations
• Added support for configurable log level in privacy plugin
• Added support for processing of external links in privacy plugin
• Added support for automatic image optimization via optimize plugin
• Added support for navigation paths (breadcrumbs)
• Fixed #​8519: Vector accents do not render when using KaTeX

v9.6.23: mkdocs-material-9.6.23

Compare Source

• Updated Burmese translation

v9.6.22: mkdocs-material-9.6.22

Compare Source

• Updated Georgian translation

v9.6.21: mkdocs-material-9.6.21

Compare Source

• Updated Serbian translations
• Fixed #​8458: Temporary pin of click dependency

v9.6.20: mkdocs-material-9.6.20

Compare Source

• Fixed #​8446: Deprecation warning as of Python 3.14 in Emoji extension
• Fixed #​8440: & character not escaped in search highlighting
• Fixed #​8439: FontAwesome icons color not set in social cards (regression)

v9.6.19: mkdocs-material-9.6.19

Compare Source

• Added support for Python 3.14
• Updated Bahasa Malaysia translations

v9.6.18: mkdocs-material-9.6.18

Compare Source

• Updated Azerbaijani translations
• Fixed last compat issues with minijinja, now 100% compatible

v9.6.17: mkdocs-material-9.6.17

Compare Source

• Fixed #​8396: Videos do not autoplay when inside a content tab
• Fixed #​8394: Stroke width not effective in Mermaid.js diagrams
• Fixed disappearing version selector when hiding page title

v9.6.16: mkdocs-material-9.6.16

Compare Source

• Fixed #​8349: Info plugin doesn't correctly detect virtualenv in some cases
• Fixed #​8334: Find-in-page detects matches in hidden search result list